home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / lshaderange.z / lshaderange
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. llllsssshhhhaaaaddddeeeerrrraaaannnnggggeeee((((3333GGGG))))                                                llllsssshhhhaaaaddddeeeerrrraaaannnnggggeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      llllsssshhhhaaaaddddeeeerrrraaaannnnggggeeee - sets range of color indices used for depth-cueing
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd llllsssshhhhaaaaddddeeeerrrraaaannnnggggeeee((((lllloooowwwwiiiinnnn,,,, hhhhiiiigggghhhhiiiinnnn,,,, zzzznnnneeeeaaaarrrr,,,, zzzzffffaaaarrrr))))
  13.      CCCCoooolllloooorrrriiiinnnnddddeeeexxxx lllloooowwwwiiiinnnn,,,, hhhhiiiigggghhhhiiiinnnn;;;;
  14.      lllloooonnnngggg zzzznnnneeeeaaaarrrr,,,, zzzzffffaaaarrrr;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _l_o_w_i_n    expects the low-intensity color map index.
  18.  
  19.      _h_i_g_h_i_n   expects the high-intensity color map index.
  20.  
  21.      _z_n_e_a_r    expects the nearer screen z, to which highin is mapped.
  22.  
  23.      _z_f_a_r     expects the farther screen z, to which lowin is mapped.
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      llllsssshhhhaaaaddddeeeerrrraaaannnnggggeeee sets the range of color indices used for depth-cueing.  The
  27.      screen z range [_z_n_e_a_r, _z_f_a_r] is mapped linearly into the color index
  28.      range [_h_i_g_h_i_n, _l_o_w_i_n].  Screen z values nearer than _z_n_e_a_r map to _h_i_g_h_i_n;
  29.      screen z values farther than _z_f_a_r map to _l_o_w_i_n.
  30.  
  31.      The valid range for _z_n_e_a_r and _z_f_a_r depends on the state of the
  32.      GLC_ZRANGEMAP compatibility mode (see ggggllllccccoooommmmppppaaaatttt).  If it is 0, the valid
  33.      range depends on the graphics hardware.  When multisample is enabled, and
  34.      multisample buffers exist in the current framebuffer configuration in the
  35.      current drawmode, the minimum is the value returned by
  36.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____MMMMSSSS____ZZZZMMMMIIIINNNN)))) and the maximum is the value returned by
  37.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____MMMMSSSS____ZZZZMMMMAAAAXXXX)))).  Otherwise, the minimum is the value returned by
  38.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____ZZZZMMMMIIIINNNN)))) and the maximum is the value returned by
  39.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____ZZZZMMMMAAAAXXXX)))).  If the state of the GLC_ZRANGEMAP compatibility
  40.      mode is 1, the minimum is 0x0 and the maximum is 0x7FFFFF.  The default
  41.      is llllsssshhhhaaaaddddeeeerrrraaaannnnggggeeee((((0000,,,, 7777,,,, _Z_m_i_n,,,, _Z_m_a_x)))), where _Z_m_i_n and _Z_m_a_x are the values such
  42.      that the full range supported by the graphics hardware is used.
  43.  
  44.      _Z_n_e_a_r and _z_f_a_r should be chosen to be consistent with the _n_e_a_r and _f_a_r
  45.      parameters passed to llllsssseeeettttddddeeeepppptttthhhh.... If _n_e_a_r < _f_a_r, then _z_n_e_a_r should be less
  46.      than _z_f_a_r.  If _n_e_a_r > _f_a_r, then _z_n_e_a_r should be greater than _z_f_a_r.  In
  47.      either case, the range [_n_e_a_r, _f_a_r] should bound the range [_z_n_e_a_r, _z_f_a_r].
  48.  
  49. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  50.      depthcue, getgdesc, glcompat, lsetdepth
  51.  
  52. NNNNOOOOTTTTEEEE
  53.      When using this routine, you should always explicitly set the
  54.      GLC_ZRANGEMAP mode of ggggllllccccoooommmmppppaaaatttt because its default is different on
  55.      different models.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.